home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / timidsrc.zip / INSTALL < prev    next >
Text File  |  1996-05-20  |  4KB  |  130 lines
  1. ---------------------------------*-text-*---------------------------------
  2.  
  3.     TiMidity -- Experimental MIDI to WAVE converter
  4.     Copyright (C) 1995 Tuukka Toivonen <toivonen@clinet.fi>
  5.  
  6. --------------------------------------------------------------------------
  7.  
  8.     INSTALLATION INSTRUCTIONS
  9.  
  10. --------------------------------------------------------------------------
  11.  
  12.     You need at least the source distribution ("timidity-0.2i.tar.gz"
  13. or later).  If you don't have any GUS-compatible patches or MIDI files,
  14. you should also get "timidity-lib-0.2.tar.gz", which contains Dustin
  15. McCartney's excellent acoustic piano and nylon guitar patches, and some
  16. sample MIDI files.  If you already have "timidity-lib-0.1.tar.gz" from an
  17. earlier installation, it's the exact same thing except for a few words in
  18. the README file.  Unpack the library archive under the directory
  19. "timidity-0.2i".  Now cd into "timidity-0.2i" and follow the four easy
  20. steps:
  21.  
  22.     The archives are also available as "timid02i.zip" and
  23. "tilib02.zip".  A 32-bit Windows executable is available in
  24. "tim3202i.zip" in case you don't want to build it from scratch.
  25.  
  26. Compiling (UNIX):
  27.  
  28. (1)    Check the options in the Makefile:
  29.  
  30.         a: select the audio driver by uncommenting one of the
  31.                following:
  32.             * Linux/FreeBSD audio driver      
  33.                 * HP-UX network audio server
  34.             * Sun audio driver
  35.             * DEC MME driver
  36.  
  37.         b: select the kind of interface you want:
  38.             * ncurses full-screen interface
  39.             * S-Lang full-screen interface
  40.             * X-MOTIF interface
  41.             * Tcl/Tk interface
  42.  
  43.         You can select more than one interface and then use the -i
  44.         option to pick one at runtime.  If you can compile a
  45.         statically linked Motif binary for Linux, please email me!
  46.  
  47.         If your make won't +=, edit the Makefile as if it did, and
  48.         then type "./my make right or wrong" in the distribution
  49.         directory.
  50.  
  51.     and say:
  52.  
  53.         make
  54.  
  55.     If TiMidity won't compile, check paths to headers and libraries,
  56.     edit the Makefile appropriately, and try again.  Note that you'll
  57.     need ncurses to build the ncurses interface.  Also check config.h.
  58.     Email me if you need to make nontrivial adjustments to get it to
  59.     work.
  60.  
  61.  
  62. Compiling (Windows):
  63.  
  64. (1)    Use Borland C++ 4.51 to compile TiMidity.  In case of trouble,
  65.     please email Davide Moretti <dmoretti@iper.net> or use the
  66.     prebuilt executable.
  67.  
  68.  
  69. Testing:
  70.  
  71. (2)    Adjust audio volume to a comfortable level and say:
  72.  
  73.     Linux/FreeBSD:
  74.  
  75.         ./timidity -OdM -s22 midi/impromptu.mid
  76.  
  77.     HP-UX (you need to be running the HP network audio server):
  78.  
  79.         ./timidity -OdM -s16 -o `hostname` midi/impromptu.mid
  80.  
  81.     SunOS:
  82.  
  83.         ./timidity -OdM -s22050 midi/impromptu.mid
  84.  
  85.     Windows:
  86.  
  87.         timidity -OdM -s22050 midi/impromptu.mid
  88.  
  89.     System without audio driver (a 2,335,998-byte, 8-kHz uLaw file
  90.     "output.au" will be generated):
  91.  
  92.         ./timidity -OrMU -s8 -o output.au midi/impromptu.mid
  93.  
  94.     You should get a rendition of Chopin's Fantasie Impromptu.  
  95.     If not, and you're running Linux, try making noise with some
  96.     other software to make sure your sound hardware is working
  97.     properly. On systems other than Linux, you may need to fiddle
  98.     with the options.  Let me know what works.
  99.  
  100.     If you get choppy sound, make sure TiMidity is getting enough CPU
  101.     time. You can try using a lower sampling rate (the -s option).
  102.  
  103.  
  104. Installing:
  105.  
  106. (3)    When you've got a working executable, you can check the target
  107.     directories in the Makefile, become root if necessary, and say:
  108.  
  109.         make install.all
  110.  
  111.     to install the executable, the manual page, and the support files
  112.     (patches and MIDI examples) in the directories specified. If you
  113.     don't wish to install the support files, you can say:
  114.  
  115.         make install.bin install.man
  116.  
  117.     to install just the executable and the manual page.
  118.  
  119.  
  120. Using:
  121.  
  122. (4)    Now you can play around with the options to get the best sound
  123.     quality. 
  124.  
  125.         timidity -h
  126.  
  127.     will get you a brief list. More detailed information is available
  128.     in the manual page. Also, check out the FAQ for pointers to more 
  129.     instruments and MIDI files.
  130.